中文 | English

gstack

“我觉得自己大概从去年 12 月起就几乎没再手写过哪怕一行代码了，这真的是一个极其巨大的变化。” — Andrej Karpathy，No Priors 播客，2026 年 3 月

当我听到 Karpathy 这么说时，我想弄清楚原因。一个人究竟是怎么做到像二十人团队那样交付的？Peter Steinberger 基本上是靠 AI agents 几乎单枪匹马搭出了 OpenClaw —— GitHub 24.7 万星。革命已经来了。只要工具选对，一个独立构建者就能比传统团队推进得更快。

我是 Garry Tan，Y Combinator 总裁兼 CEO。我和成千上万家创业公司一起工作过 —— Coinbase、Instacart、Rippling —— 那时它们都还只是车库里的一两个人。在 YC 之前，我是 Palantir 最早的一批工程/产品/设计成员之一，共同创办了 Posterous（后卖给 Twitter），还构建了 YC 内部社交网络 Bookface。

gstack 就是我的答案。 我做产品已经二十年了，而现在我写出的生产代码比以往任何时候都多。过去 60 天里：60 万+ 行生产代码（其中 35% 是测试），每天 1 万到 2 万行，而且是在全职运营 YC 的同时兼职完成的。下面是我在 3 个项目上的上一次 /retro：一周内 新增 140,751 行、362 次提交、净增约 11.5 万行代码。

2026 年 —— 1,237 次 contribution，还在继续：

2013 年 —— 我在 YC 做 Bookface 时（772 次 contribution）：

还是同一个人。只是时代不同了。差异就在工具。

gstack 就是我现在的工作方式。 它把 Claude Code 变成一个虚拟工程团队：一个重新思考产品的 CEO，一个锁定架构的工程经理，一个识别 AI 糊弄设计的设计师，一个找生产 bug 的 reviewer，一个会打开真实浏览器的 QA 负责人，一个执行 OWASP + STRIDE 审计的安全官，以及一个负责把 PR 发出去的发布工程师。23 位 specialist，加上 8 个 power tool，全部都是 slash commands，全部是 Markdown，全部免费，MIT 许可。

这是我的开源软件工厂。我每天都在用它。我把它分享出来，是因为这些工具应该人人可用。

Fork 它，改进它，变成你自己的版本。如果你只是想喷一个免费的开源软件，也欢迎，但我更希望你先试试。

这套东西适合谁：

• 创始人和 CEO，尤其是仍然想自己下场交付的技术型创始人
• 第一次使用 Claude Code 的人，因为这里提供的是结构化角色，而不是空白 prompt
• Tech Lead 和 Staff Engineer，因为每个 PR 都能得到更严格的 review、QA 和 release automation

快速开始

1. 安装 gstack（30 秒，见下文）
2. 运行 /office-hours，描述你在构建什么
3. 针对任意功能想法运行 /plan-ceo-review
4. 对任何有改动的分支运行 /review
5. 对你的 staging URL 运行 /qa
6. 到这里就够了。你很快就会知道这东西适不适合你

安装：30 秒

要求： Claude Code、Git、Bun v1.0+、Node.js（仅 Windows 需要）

第 1 步：在你的机器上安装

打开 Claude Code，把下面这段贴进去。剩下的都由 Claude 完成。

安装 gstack：运行 git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup，然后在 CLAUDE.md 里添加一个 “gstack” 小节，写明：所有网页浏览都使用 gstack 的 /browse skill，绝不使用 mcp__claude-in-chrome__* 工具，并列出可用 skills：/office-hours、/plan-ceo-review、/plan-eng-review、/plan-design-review、/design-consultation、/design-shotgun、/design-html、/review、/ship、/land-and-deploy、/canary、/benchmark、/browse、/connect-chrome、/qa、/qa-only、/design-review、/setup-browser-cookies、/setup-deploy、/retro、/investigate、/document-release、/codex、/cso、/autoplan、/plan-devex-review、/devex-review、/careful、/freeze、/guard、/unfreeze、/gstack-upgrade、/learn。然后询问用户，是否也要把 gstack 加进当前项目，以便队友也能获得它。

每位开发者都在全局范围安装，更新会自动发生：

cd ~/.claude/skills/gstack && ./setup --team

然后为你的仓库做 bootstrap，这样队友也能得到它：

cd <your-repo>
~/.claude/skills/gstack/bin/gstack-team-init required  # 或者：optional
git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"

不需要把 vendored 文件塞进仓库，不会有版本漂移，也不需要手动升级。每次 Claude Code session 启动时都会做一次快速自动升级检查（每小时最多一次、网络失败安全、完全静默）。

如果你要参与贡献或需要完整历史？ 上面的命令使用了 --depth 1 以加快安装速度。如果你打算贡献代码，或者需要完整 git 历史，请改用完整 clone：

git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack

OpenClaw

OpenClaw 通过 ACP 启动 Claude Code session，因此只要 Claude Code 已安装 gstack，所有 gstack skill 都能工作。把下面这段粘贴给你的 OpenClaw agent：

安装 gstack：运行 git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup，为 Claude Code 安装 gstack。然后在 AGENTS.md 中新增一个 “Coding Tasks” 小节，写明：当为编码工作启动 Claude Code session 时，要告诉该 session 使用 gstack skills。附上这些示例 —— 安全审计：“Load gstack. Run /cso”，代码审查：“Load gstack. Run /review”，QA 测试某个 URL：“Load gstack. Run /qa https://...”，端到端实现一个功能：“Load gstack. Run /autoplan, implement the plan, then run /ship”，构建前先做规划：“Load gstack. Run /office-hours then /autoplan. Save the plan, don't implement.”

完成 setup 后，只要自然地和你的 OpenClaw agent 说话即可：

你说	实际发生的事
“Fix the typo in README”	简单任务 —— 启动 Claude Code session，不需要 gstack
“Run a security audit on this repo”	启动 Claude Code，并执行 Run /cso
“Build me a notifications feature”	启动 Claude Code，并执行 /autoplan -> implement -> /ship
“Help me plan the v2 API redesign”	启动 Claude Code，并执行 /office-hours -> /autoplan，然后保存计划

高级路由与 gstack-lite/gstack-full prompt 模板见 docs/OPENCLAW.md。

OpenClaw 原生 Skills（通过 ClawHub）

有四个方法论型 skill 可直接在你的 OpenClaw agent 中工作，不需要再起 Claude Code session。通过 ClawHub 安装：

clawhub install gstack-openclaw-office-hours gstack-openclaw-ceo-review gstack-openclaw-investigate gstack-openclaw-retro

Skill	它的作用
gstack-openclaw-office-hours	用 6 个强制问题做产品拷问
gstack-openclaw-ceo-review	用 4 种 scope 模式做战略挑战
gstack-openclaw-investigate	根因调试方法论
gstack-openclaw-retro	每周工程复盘

这些都是对话型 skill。你的 OpenClaw agent 可以直接通过聊天调用它们。

其他 AI Agents

gstack 支持 8 种 AI coding agents，不只是 Claude。安装脚本会自动检测你装了哪些 agent：

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup

或者通过 ./setup --host <name> 明确指定某个 agent：

Agent	Flag	Skills 安装位置
OpenAI Codex CLI	--host codex	~/.codex/skills/gstack-*/
OpenCode	--host opencode	~/.config/opencode/skills/gstack-*/
Cursor	--host cursor	~/.cursor/skills/gstack-*/
Factory Droid	--host factory	~/.factory/skills/gstack-*/
Slate	--host slate	~/.slate/skills/gstack-*/
Kiro	--host kiro	~/.kiro/skills/gstack-*/

想支持别的 agent？ 参见 docs/ADDING_A_HOST.md。只需要一个 TypeScript 配置文件，零代码改动。

看看它是怎么工作的

你：    我想做一个给日历用的 daily briefing 应用。
你：    /office-hours
Claude： [开始问你的痛点，要具体例子，不要空泛假设]

你：    多个 Google 日历，事件信息经常过期，地点也不准。
        做准备要花很久，而且结果也不够好……

Claude： 我要先挑战一下你的 framing。你说你要做的是 “daily briefing
        app”，但你真正描述的其实是一个个人 chief of
        staff AI。
        [提炼出 5 个你自己都没意识到的能力]
        [挑战 4 个前提 —— 你可以同意、反对或调整]
        [生成 3 种实现路径并估算工作量]
        RECOMMENDATION：明天就把最窄的一块先发出去，从真实使用里学习。
        完整愿景是一个 3 个月的项目 —— 先把真正可用的
        daily briefing 做出来。
        [写出 design doc -> 自动供后续 skills 读取]

你：    /plan-ceo-review
        [读取 design doc，挑战 scope，运行 10 个部分的 review]

你：    /plan-eng-review
        [产出数据流、状态机、错误路径的 ASCII 图]
        [测试矩阵、失败模式、安全顾虑]

你：    Approve plan. Exit plan mode.
        [在 11 个文件里写了 2,400 行代码。约 8 分钟。]

你：    /review
        [AUTO-FIXED] 2 issues. [ASK] Race condition -> 你批准修复。

你：    /qa https://staging.myapp.com
        [打开真实浏览器，点击流程，发现并修复了一个 bug]

你：    /ship
        Tests: 42 -> 51（新增 9 个）。PR: github.com/you/app/pull/42

你说的是 “daily briefing app”。agent 听到的却是 “你在做一个 chief of staff AI” —— 因为它真正听的是你的痛点，而不是你表面的 feature request。八个命令，从头到尾。这不是 copilot。这是一个团队。

冲刺流程

gstack 不是一组零散工具，而是一套流程。skills 的执行顺序和真实 sprint 一样：

Think -> Plan -> Build -> Review -> Test -> Ship -> Reflect

每个 skill 都为下一个 skill 提供输入。/office-hours 会写出 design doc，供 /plan-ceo-review 读取；/plan-eng-review 会写出 test plan，供 /qa 使用；/review 会发现 bug，而 /ship 会验证它们是否已修复。因为每一步都知道上一步发生了什么，所以不会有任何事情掉到地上。

Skill	你的 specialist	它做什么
/office-hours	YC Office Hours	从这里开始。用 6 个强制问题在写代码前重构你的产品定义。它会挑战 framing、质疑前提、生成实现替代方案。产出的 design doc 会进入所有下游 skill。
/plan-ceo-review	CEO / Founder	重新定义问题。找出需求背后那个 10 星级产品。四种模式：Expansion、Selective Expansion、Hold Scope、Reduction。
/plan-eng-review	工程经理	锁定架构、数据流、图示、边界情况和测试。把隐藏假设强制暴露出来。
/plan-design-review	资深设计师	给每个设计维度打 0-10 分，解释 10 分长什么样，然后直接修改计划去逼近 10 分。负责识别 AI Slop。交互式工作流，每个设计决策只问一个 AskUserQuestion。
/plan-devex-review	开发者体验负责人	交互式 DX 评审：探索开发者画像，和竞品的 TTHW 对标，设计你的 magical moment，逐步追踪摩擦点。三种模式：DX EXPANSION、DX POLISH、DX TRIAGE。20-45 个强制问题。
/design-consultation	设计伙伴	从零开始构建设计系统。研究市场格局，提出有风险但更有辨识度的选择，生成真实感产品 mockup。
/review	Staff Engineer	找出那些能过 CI、但在生产中会炸的 bug。自动修掉显而易见的问题，并指出 completeness gap。
/investigate	Debugger	系统化根因调试。铁律是：不先调查，就不允许修。追踪数据流，验证假设，连续 3 次错误修复后就停止蛮干。
/design-review	会写代码的设计师	用和 /plan-design-review 一样的审计标准，然后把发现的问题真正修掉。原子提交，带 before/after 截图。
/devex-review	DX Tester	实时开发者体验审计。真的去跑你的 onboarding：打开文档、试 getting started、测 TTHW、截取错误画面。再和 /plan-devex-review 的分数比对，验证你的计划是否符合现实。
/design-shotgun	设计探索者	“给我看选项。” 生成 4-6 个 AI mockup 变体，在浏览器里打开对比板，收集你的反馈，然后继续迭代。taste memory 会逐步学习你的偏好。直到你真的喜欢，再交给 /design-html。
/design-html	设计工程师	把 mockup 变成真正可工作的生产级 HTML。使用 Pretext 做计算式文本布局：文本会随尺寸变化重新排版，高度会随内容调整，布局是动态的。30KB、零依赖。还能识别 React/Svelte/Vue。它交付的是可上线成果，而不是 demo。
/qa	QA 负责人	测试你的应用，找 bug，用原子提交修复，再重新验证。每个修复都会自动生成回归测试。
/qa-only	QA 报告员	和 /qa 方法相同，但只出报告，不改代码。
/pair-agent	多 agent 协调器	把你的浏览器共享给任何 AI agent。一个命令、一段粘贴、立即连通。支持 OpenClaw、Hermes、Codex、Cursor 或任何能执行 curl 的 agent。每个 agent 一个独立 tab。自动启动有头模式，自动拉起 ngrok，具备 scoped token、tab 隔离、限流和活动归因。
/cso	首席安全官	OWASP Top 10 + STRIDE threat model。零噪声：17 条 false positive 排除规则、8/10+ 置信度阈值、独立 finding 验证。每条 finding 都附带具体 exploit 场景。
/ship	发布工程师	同步 main、运行测试、审计覆盖率、push、开 PR。即便项目没有测试框架，它也会先帮你 bootstrap。
/land-and-deploy	发布工程师	合并 PR，等待 CI 和部署完成，验证生产健康。从 “approved” 到 “production verified” 一个命令走完。
/canary	SRE	部署后的监控循环。盯控制台错误、性能回退和页面故障。
/benchmark	性能工程师	建立页面加载时间、Core Web Vitals 和资源体积基线；每个 PR 对比前后变化。
/document-release	技术写作者	更新所有项目文档，使之与刚刚发布的内容一致。会自动发现过期 README。
/retro	工程经理	团队感知的每周复盘。按人拆解，跟踪交付 streak、测试健康趋势和成长机会。/retro global 能跨项目和 AI 工具（Claude Code、Codex、Gemini）运行。
/browse	QA 工程师	给 agent 装上眼睛。真实 Chromium、真实点击、真实截图。每个命令约 100ms。/open-gstack-browser 会启动带侧栏、抗 bot、自动模型路由的 GStack Browser。
/setup-browser-cookies	会话管理员	把你真实浏览器（Chrome、Arc、Brave、Edge）的 cookies 导入到无头会话，用于测试已登录页面。
/autoplan	评审流水线	一个命令得到完整评审过的计划。自动串行运行 CEO -> design -> eng -> DX，并编码决策原则。只把真正需要你批准的审美决策抛出来。
/learn	记忆	管理 gstack 在跨 session 中学到的内容。审查、搜索、清理、导出项目级模式、陷阱和偏好。积累越多，gstack 越了解你的代码库。

我该用哪一种 review？

构建对象	计划阶段（写代码前）	已交付后的 live 审计
终端用户（UI、Web 应用、移动端）	/plan-design-review	/design-review
开发者（API、CLI、SDK、文档）	/plan-devex-review	/devex-review
架构（数据流、性能、测试）	/plan-eng-review	/review
以上全部	/autoplan（自动运行 CEO -> design -> eng -> DX，并自动识别哪些适用）	—

Power tools

Skill	它的作用
/codex	Second Opinion —— 来自 OpenAI Codex CLI 的独立代码审查。三种模式：review（带 pass/fail gate）、adversarial challenge、open consultation。若 /review 和 /codex 都跑过，还会给出 cross-model analysis。
/careful	安全护栏 —— 在危险命令前告警，例如 rm -rf、DROP TABLE、force-push。说一句 “be careful” 即可激活。任何警告都可人工覆盖。
/freeze	编辑锁 —— 把文件编辑范围限制在一个目录，防止调试时误改无关文件。
/guard	完整安全模式 —— 把 /careful 和 /freeze 合并成一个命令。生产环境工作时的最高安全等级。
/unfreeze	解锁 —— 解除 /freeze 设定的边界。
/open-gstack-browser	GStack Browser —— 启动带侧栏、抗 bot、自动模型路由（Sonnet 负责动作，Opus 负责分析）、一键导入 cookies，以及 Claude Code 集成的 GStack Browser。可以清理页面、智能截图、改 CSS，并把信息回传到终端。
/setup-deploy	部署配置器 —— 为 /land-and-deploy 做一次性配置。自动检测你的平台、生产 URL 和部署命令。
/gstack-upgrade	自更新器 —— 把 gstack 升级到最新版本。能检测全局安装还是 vendored 安装，并同步两边，还会告诉你改了什么。

每个 skill 的例子与方法论深挖见这里 ->

并行冲刺

gstack 跑一个 sprint 已经很好用。真正有意思的是同时跑十个。

设计是核心。 /design-consultation 会从零构建设计系统，研究现有方案，提出带风险但更有辨识度的尝试，并写出 DESIGN.md。但真正的魔法是 shotgun 到 HTML 的这条流水线。

/design-shotgun 负责探索。 你描述想要的结果，它会用 GPT Image 生成 4-6 个 AI mockup 变体，然后在浏览器里打开一个对比面板，把所有变体并排放在一起。你挑喜欢的，留下反馈（“留白更多一点”“标题更有力量”“去掉这个渐变”），它再生成新一轮。重复，直到你真的喜欢为止。几轮之后，taste memory 会开始向你的真实偏好偏移。你不再需要用语言苦苦描述想象中的界面，而是能直接看到选项、挑出好方案，并在视觉层继续迭代。

/design-html 负责把它做实。 把已经批准的 mockup（可能来自 /design-shotgun、CEO 计划、设计 review，或者只是文字描述）转换成生产级 HTML/CSS。不是那种只在一个 viewport 宽度下看起来还行、其他地方就会散架的 AI HTML。这里用的是 Pretext 做计算式文本布局：窗口缩放时文本真的会重新流动，组件高度会根据内容变化，布局是动态的。30KB 额外开销，零依赖。它还能检测你的框架（React、Svelte、Vue），并输出正确格式。还会根据落地页、dashboard、表单、卡片布局等不同设计类型选择不同的 Pretext 模式。生成物是你真能发出去的东西，不是 demo。

/qa 是一个巨大的解锁。 它让我能把并行 worker 数从 6 提升到 12。Claude Code 先说出 “I SEE THE ISSUE”，然后真的把问题修掉、补一条回归测试、再验证修复 —— 这改变了我的工作方式。现在 agent 真正有眼睛了。

智能 review 路由。 就像一个管理良好的创业公司：CEO 不必看基础设施 bug fix，纯后端改动也不需要设计 review。gstack 会跟踪已经运行过哪些 review，判断接下来哪些最合适，然后自动做正确的事。Review Readiness Dashboard 会在你 ship 前告诉你当前状态。

测试一切。 如果项目还没有测试框架，/ship 会从零开始帮你 bootstrap。每次 /ship 都会产出覆盖率审计。每次 /qa 修 bug 都会自动生成一条回归测试。目标是 100% 测试覆盖率 —— 测试让 vibe coding 变成安全的，而不是 yolo coding。

/document-release 是你从未拥有过的工程师。 它会读取项目里的每一份文档文件，对照 diff 逐一更新漂移内容。README、ARCHITECTURE、CONTRIBUTING、CLAUDE.md、TODOS —— 都会被自动保持最新。现在 /ship 还会自动调用它 —— 不需要多一个命令，文档就能保持同步。

真实浏览器模式。 /open-gstack-browser 会启动 GStack Browser，这是一个由 AI 控制的 Chromium，内置抗 bot、定制品牌和侧栏扩展。像 Google 和纽约时报这类站点都能正常工作而不触发验证码。菜单栏显示的是 “GStack Browser”，而不是 “Chrome for Testing”。你的常规 Chrome 完全不会被污染。所有现有 browse 命令都可无缝照用。执行 $B disconnect 会切回无头模式。只要窗口还开着，浏览器就会一直活着……不会因为空闲超时而被杀掉。

侧栏 agent：你的 AI 浏览器助手。 你可以在 Chrome 侧栏里用自然语言发任务，一个子 Claude 实例就会执行它。“进入 settings 页面并截图。”“把这个表单填上测试数据。”“遍历这个列表里的每一项并提取价格。” 侧栏会自动把动作型任务路由给 Sonnet（点击、导航、截图），把阅读和分析交给 Opus。每个任务最长可跑 5 分钟。侧栏 agent 运行在隔离 session 中，因此不会干扰你的主 Claude Code 窗口。侧栏底部还支持一键导入 cookies。

个人自动化。 侧栏 agent 不只适用于开发工作流。例子：“浏览我孩子学校的家长门户，把其他家长的姓名、电话号码和照片加入我的 Google Contacts。” 有两种认证方式：(1) 你在有头浏览器里登录一次，session 会持久保留；(2) 点击侧栏底部的 “cookies” 按钮，从你真实的 Chrome 导入 cookies。认证完成后，Claude 会自己浏览目录、提取数据并创建联系人。

当 AI 卡住时，把浏览器交还给人。 碰到 CAPTCHA、认证墙或 MFA 提示？执行 $B handoff，它会在可见 Chrome 中打开完全相同的页面，并保留所有 cookies 和 tabs。你把问题处理完，告诉 Claude 已经完成，再执行 $B resume，它就会从中断点接着跑。连续 3 次失败后，agent 甚至会自动建议这么做。

/pair-agent 负责跨 agent 协作。 你在 Claude Code 里，同时也开着 OpenClaw、Hermes 或 Codex。你希望它们都看同一个网站。输入 /pair-agent，选中目标 agent，GStack Browser 就会打开一个可见窗口，供你观察。这个 skill 会打印一段说明，把它粘贴到另一个 agent 的聊天里，对方就能拿一次性 setup key 换成 session token，创建自己的 tab 并开始浏览。于是你能看到来自不同厂商的 agent 在同一个浏览器中、各自独立 tab 内协同工作，同时互相无法干扰。这是第一次，不同厂商的 AI agents 能通过共享浏览器做真正安全的协调：有 scoped token、tab 隔离、限流、域名限制和活动归因。

多 AI 的第二意见。 /codex 会调用 OpenAI Codex CLI 做一次独立 review —— 一个完全不同的 AI 看同一份 diff。三种模式：带 pass/fail gate 的代码审查、主动找你代码漏洞的 adversarial challenge，以及带 session continuity 的开放式咨询。当 /review（Claude）和 /codex（OpenAI）都 review 过同一分支时，你还会得到 cross-model analysis，区分哪些发现两边都看到了，哪些是各自独有的。

按需启用的安全护栏。 只要说一句 “be careful”，/careful 就会在任何危险命令前给出提醒 —— rm -rf、DROP TABLE、force-push、git reset --hard。/freeze 会把编辑锁在某个目录，避免 Claude 在调试时“顺手修掉”无关代码。/guard 则会同时启用两者。/investigate 在启动时会自动冻结到正在调查的模块。

主动 skill 建议。 gstack 会识别你当前所处的阶段 —— brainstorming、reviewing、debugging、testing —— 然后推荐最合适的 skill。如果你不喜欢，直接说 “stop suggesting”，它会跨 session 记住。

10-15 个并行 sprint

gstack 在单个 sprint 中已经很强大。真正的质变发生在你同时跑十个的时候。

Conductor 可以并行运行多个 Claude Code session —— 每个 session 都有独立 workspace。一个 session 跑 /office-hours 讨论新想法，另一个在 PR 上跑 /review，第三个实现功能，第四个对 staging 跑 /qa，另外六个则在其他分支上工作。全部同时进行。我经常并行运行 10-15 个 sprint —— 这差不多是目前的实际极限。

sprint 结构正是并行能够成立的原因。没有流程时，十个 agents 就是十个混乱源头。有了流程 —— think、plan、build、review、test、ship —— 每个 agent 都知道自己该做什么、何时停止。你管理它们的方式，和 CEO 管理团队一样：关键决策亲自过目，其他部分放手去跑。

语音输入（AquaVoice、Whisper 等）

gstack skills 都带有适合语音触发的短语。你只需要自然地说出需求 —— “run a security check”“test the website”“do an engineering review” —— 对应的 skill 就会自动触发。你无需死记 slash command 名称或缩写。

卸载

方案一：运行卸载脚本

如果你的机器上已经安装了 gstack：

~/.claude/skills/gstack/bin/gstack-uninstall

它会处理 skills、symlink、全局状态（~/.gstack/）、项目本地状态、browse daemon 以及临时文件。使用 --keep-state 可以保留配置和分析数据；使用 --force 可以跳过确认。

方案二：手动移除（没有本地仓库时）

如果你没有保留 repo clone（例如通过 Claude Code 粘贴安装，之后又删掉了 clone）：

# 1. 停掉 browse daemons
pkill -f "gstack.*browse" 2>/dev/null || true

# 2. 删除指向 gstack/ 的 per-skill symlink
find ~/.claude/skills -maxdepth 1 -type l 2>/dev/null | while read -r link; do
  case "$(readlink "$link" 2>/dev/null)" in gstack/*|*/gstack/*) rm -f "$link" ;; esac
done

# 3. 删除 gstack
rm -rf ~/.claude/skills/gstack

# 4. 删除全局状态
rm -rf ~/.gstack

# 5. 删除集成目录（没装过的可以跳过）
rm -rf ~/.codex/skills/gstack* 2>/dev/null
rm -rf ~/.factory/skills/gstack* 2>/dev/null
rm -rf ~/.kiro/skills/gstack* 2>/dev/null
rm -rf ~/.openclaw/skills/gstack* 2>/dev/null

# 6. 删除临时文件
rm -f /tmp/gstack-* 2>/dev/null

# 7. 每个项目的本地清理（在项目根执行）
rm -rf .gstack .gstack-worktrees .claude/skills/gstack 2>/dev/null
rm -rf .agents/skills/gstack* .factory/skills/gstack* 2>/dev/null

清理 CLAUDE.md

卸载脚本不会编辑 CLAUDE.md。在每个引入过 gstack 的项目里，手动删掉 ## gstack 和 ## Skill routing 这两个小节。

Playwright

~/Library/Caches/ms-playwright/（macOS）不会被删除，因为其他工具也可能共用它。若确认没有任何工具需要它，再手动删掉。

---

免费、MIT 许可、开源。没有 premium tier，也没有 waitlist。

我把自己构建软件的方式开源了。你可以 fork 它，把它变成自己的。

我们在招人。 想每天交付 1 万+ 行代码，并帮助打磨 gstack？来 YC 吧 —— ycombinator.com/software。薪酬和股权都极具竞争力。工作地点：旧金山 Dogpatch District。

文档

文档	内容
Skill Deep Dives	每个 skill 的方法论、示例和工作流（含 Greptile 集成）
Builder Ethos	Builder 哲学：Boil the Lake、Search Before Building、三层知识模型
Architecture	设计决策与系统内部实现
Browser Reference	/browse 的完整命令参考
Contributing	开发环境、测试、contributor mode 与 dev mode
Changelog	每个版本的新内容

gstack 带有可选加入的使用遥测，用来帮助改进项目。实际机制如下：

• 默认关闭。 除非你明确同意，否则不会向任何地方发送任何内容。
• 首次运行时， gstack 会询问你是否愿意分享匿名使用数据。你可以拒绝。
• 如果你选择加入，会发送这些内容： skill 名称、运行时长、成功/失败、gstack 版本、操作系统。仅此而已。
• 绝不会发送： 代码、文件路径、仓库名、分支名、prompt，或任何用户生成内容。
• 随时关闭： gstack-config set telemetry off 会立即完全禁用遥测。

数据存储在 Supabase（开源版 Firebase 替代品）中。schema 位于 supabase/migrations/ —— 你可以自行核查到底收集了什么。仓库中的 Supabase publishable key 是公开 key（类似 Firebase API key）；行级安全策略会阻止任何直接访问。遥测数据会通过经过校验的 edge functions 进入系统，它们会强制执行 schema 校验、事件类型 allowlist 和字段长度限制。

本地分析始终可用。 运行 gstack-analytics，就能从本地 JSONL 文件查看个人使用仪表盘 —— 完全不依赖远端数据。

故障排查

Skill 没出现？ cd ~/.claude/skills/gstack && ./setup

/browse 失败？ cd ~/.claude/skills/gstack && bun install && bun run build

安装过旧？ 运行 /gstack-upgrade —— 或者在 ~/.gstack/config.yaml 中设置 auto_upgrade: true

想要更短的命令名？ cd ~/.claude/skills/gstack && ./setup --no-prefix —— 会把 /gstack-qa 切换成 /qa。这个选择会在以后升级时被记住。

想要带命名空间的命令？ cd ~/.claude/skills/gstack && ./setup --prefix —— 会把 /qa 切换成 /gstack-qa。如果你同时使用其他 skill pack，这会更合适。

Codex 报 “Skipped loading skill(s) due to invalid SKILL.md” ？ 说明你的 Codex skill descriptions 已经过时。修复方法：cd ~/.codex/skills/gstack && git pull && ./setup --host codex —— 如果是 repo-local 安装，则执行：cd "$(readlink -f .agents/skills/gstack)" && git pull && ./setup --host codex

Windows 用户： gstack 可以在 Windows 11 的 Git Bash 或 WSL 中工作。除了 Bun，还需要安装 Node.js —— Bun 在 Windows 上的 Playwright pipe transport 有一个已知 bug（bun#4253）。browse server 会自动回退到 Node.js。请确保 bun 和 node 都在你的 PATH 中。

Claude 说它看不到 skills？ 确认你项目里的 CLAUDE.md 包含 gstack 小节。加入如下内容：

## gstack
Use /browse from gstack for all web browsing. Never use mcp__claude-in-chrome__* tools.
Available skills: /office-hours, /plan-ceo-review, /plan-eng-review, /plan-design-review,
/design-consultation, /design-shotgun, /design-html, /review, /ship, /land-and-deploy,
/canary, /benchmark, /browse, /open-gstack-browser, /qa, /qa-only, /design-review,
/setup-browser-cookies, /setup-deploy, /retro, /investigate, /document-release, /codex,
/cso, /autoplan, /pair-agent, /careful, /freeze, /guard, /unfreeze, /gstack-upgrade, /learn.